Skip to main content

更改 OAuth 范围

如何添加或删除 OAuth 范围。

对用户的影响​

当集成的新版本中的某个操作需要额外的 OAuth 范围时，您必须要求用户在可以使用新操作之前重新连接现有的已连接账户，没有其他办法。

您只能在没有任何操作需要该范围时删除它。请注意，现有的已连接账户可能仍然被授予了这些范围，只有在它们重新连接时才会失去这些范围。

最佳实践​

在添加新范围时，请遵循以下步骤，以提供最佳的用户体验。

  1. 在需要额外范围的新版本中，尝试使用现有的已连接账户执行操作，并使用错误处理来确保错误消息指导用户重新连接账户。

  2. 在新版本中，将所需的范围添加到 UI 中的“范围”字段（在 UI 中），或 CLI 中的scope（在 CLI 中）。

您可能还需要为集成使用的 OAuth 客户端选择这些范围，以便我们能够请求它们。
3. 通过使用新版本连接账户，验证操作现在是否正常工作。

  1. 推广新版本。

  2. 迁移100% 的用户到新版本。

最后两个步骤至关重要，因为它们能让用户通过重新连接现有的已连接账户来采用新范围。